home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Utilities / Unix / The-Disk-Scripts / README < prev   
Encoding:
Text File  |  1996-03-13  |  4.8 KB  |  129 lines
  1.  
  2. AUTHOR:  Timothy J. Luoma <luomat@capitalist.princeton.edu>
  3.  
  4. DATE:    14 March 1996
  5.  
  6. WARNING: USE ENTIRELY AT YOUR OWN RISK
  7.  
  8. TESTED UNDER: NeXTStep 3.2 on my NeXTStation (owners of other
  9.     architectures, please see note below: OTHER ARCHS)
  10.  
  11.  
  12. Now that we've gotten that out of the way, let's talk.
  13.  
  14. TABLE OF CONTENTS:
  15.     This is a very small collection of 3 /bin/sh scripts
  16.     which are designed to manipulate disks from the
  17.     command line.
  18.  
  19.     eject.sh  - eject disks (floppy or CD)
  20.     ff      - format floppy disks (FLOPPY ONLY)
  21.     mntdisk      - mount disks (floppy or CD)
  22.  
  23. NONE OF THESE SCRIPTS HAVE BEEN TESTED WITH Optical
  24.     Disks, Jazz Disks, Zip Disks, or any other kind of
  25.     Disk besides 3.5" disks and CD-ROMs.
  26.  
  27. NOTE: 
  28.     All of these scripts are designed to work
  29.     only when run as root.  To get around that
  30.     you'd have to change the permissions to the
  31.     following commands: mount, umount, disk,
  32.     /usr/filesystems/DOS.fs/DOS.util, and
  33.     /usr/filesystems/mac.fs/mac.util
  34.  
  35. HISTORY: 
  36.     I got tired of having to refer to the 'disk',
  37.     'mount/umount', and 'fstab' man pages every time
  38.     I wanted to eject a disk, or format a disk, or
  39.     mount a disk manually.  This was made more difficult
  40.     by the fact that it seems like two different devices
  41.     are used for both NeXT floppy disks and others
  42.     (either /dev/fd0a or /dev/rfd0b, respectively),
  43.     and for NeXT CDs and other types of CDs (/dev/sd2a
  44.     or /dev/rsd2h).  When you 'mount' you don't use
  45.     the raw device, and when you use 'disk -e' you do,
  46.     except sometimes, etc etc etc.  If the 'umount'
  47.     fails and you do 'disk -e' then you can really
  48.     screw things up...
  49.  
  50.     Well, these scripts try to take the guess work out
  51.     of all that.
  52.  
  53.     'ff' and 'mntdisk' can be run in either LINE MODE
  54.     (in case you know the format of the information
  55.     they want) or INTERACTIVE MODE (in case you don't).
  56.  
  57.     'eject.sh' just needs the name of the mountpoint
  58.     (ie if you have a disk named '/mydisk', then use:
  59.     'eject.sh /mydisk')
  60.  
  61. YOU REALLY SHOULD read through the code to each of
  62.     the scripts... I've tried to be thorough in my
  63.     comments.  If you don't understand something, then
  64.     please ask.  I've caused a few panics on my machine
  65.     using these scripts, and taken that knowledge and
  66.     tried to build in safety checks to the scripts.
  67.  
  68. EJECT.SH:
  69.     Observant 'netwatchers will know that 'eject.sh'
  70.     has been previously released.  This is not a new
  71.     version, but I include it because I think it is
  72.     useful, especially when dealing with a bug in
  73.     'mntdisk' where the disk shows up in the File Viewer
  74.     but the 'Disk->Eject' menu is still grey (if anyone
  75.     figures out why that happens occasionally, please
  76.     let me know).  Feel free to rename it 'eject' if
  77.     you don't already have an 'eject' somewhere on your
  78.     NeXTStep machine.  I am aware that there are several
  79.     binaries out there by the name 'eject' so I wanted
  80.     to differentiate this one by indicating that it is
  81.     a /bin/sh script.
  82.     
  83. OTHER ARCHS:
  84.     I've never used any other NeXTStep machine than
  85.     the NeXTStation for more than a few minutes.  I
  86.     don't know what 'disk -e' does on those machines
  87.     (on my NeXTStation it causes the disk to be ejected,
  88.     hopefully after the 'umount' command has been
  89.     invoked).  Please be careful with these scripts.
  90.     If someone were to tell me what 'disk -e' does,
  91.     I'd appreciate it (my guess is that it depends on
  92.     what type of disk drive you have).
  93.  
  94. "TERMS OF AGREEMENT":
  95.     I really don't want any $ or anything else for
  96.     these.  I wrote them for me, and thought others
  97.     might find them useful.  I just ask that if you
  98.     use them, you let me know.  If you want to
  99.     update/revise/distribute them, please feel free.
  100.     All I ask/require is that you keep track of your
  101.     updates (so I know what has changed since I released
  102.     them) and let me know of any changes you make.  If
  103.     you are going to include them as part of some
  104.     collection, great! Please let me know that too.
  105.     If you use them and find them helpful, please drop
  106.     me a note.  I promise it will make my day.
  107.  
  108. FINAL WORDS:
  109.     Please remember these are basically hacks.  If you
  110.     don't do what they expect as they expect them, they
  111.     won't work.  Hopefully I've been smart enough to
  112.     have them quit before doing any damage, but I cannot
  113.     possible be expected to know how someone else is
  114.     going to wrongly use these scripts.  They are
  115.     commented on extensively; 2 of them have interactive
  116.     modes to guide you, and the other is ridiculously
  117.     simple to use.  But my mission in my (computer)
  118.     life is to find simple solutions to complex problems
  119.     while making things as easy for myself as possible.
  120.     I'd rather write these scripts once and never again
  121.     have to remember how to correctly manually
  122.     mount/eject/format, because I believe that we have
  123.     a limited amount of memory we can use.  The more
  124.     memory we can free up by not having to remember
  125.     such picayune drivel as correct syntax for UNIX
  126.     commands, the better off we as a planet will be.
  127.     
  128. <end>
  129.